<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>X Window System Interaction</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GDK 3 参考手册">
<link rel="up" href="reference.html" title="API参考">
<link rel="prev" href="gdk3-Cairo-Interaction.html" title="Cairo Interaction">
<link rel="next" href="gdk3-Application-launching.html" title="Application launching">
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gdk3-Cairo-Interaction.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GDK 3 参考手册</th>
<td><a accesskey="n" href="gdk3-Application-launching.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gdk3-X-Window-System-Interaction.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gdk3-X-Window-System-Interaction.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gdk3-X-Window-System-Interaction"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gdk3-X-Window-System-Interaction.top_of_page"></a>X Window System Interaction</span></h2>
<p>X Window System Interaction — X backend-specific functions</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gdk3-X-Window-System-Interaction.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gdk/gdkx.h&gt;

#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-ROOT-WINDOW:CAPS" title="GDK_ROOT_WINDOW">GDK_ROOT_WINDOW</a>
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-WINDOW-XID:CAPS" title="GDK_WINDOW_XID()">GDK_WINDOW_XID</a>                      (win)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-DISPLAY-XDISPLAY:CAPS" title="GDK_DISPLAY_XDISPLAY()">GDK_DISPLAY_XDISPLAY</a>                (display)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-SCREEN-XDISPLAY:CAPS" title="GDK_SCREEN_XDISPLAY()">GDK_SCREEN_XDISPLAY</a>                 (screen)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-SCREEN-XNUMBER:CAPS" title="GDK_SCREEN_XNUMBER()">GDK_SCREEN_XNUMBER</a>                  (screen)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-SCREEN-XSCREEN:CAPS" title="GDK_SCREEN_XSCREEN()">GDK_SCREEN_XSCREEN</a>                  (screen)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-CURSOR-XCURSOR:CAPS" title="GDK_CURSOR_XCURSOR()">GDK_CURSOR_XCURSOR</a>                  (cursor)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-CURSOR-XDISPLAY:CAPS" title="GDK_CURSOR_XDISPLAY()">GDK_CURSOR_XDISPLAY</a>                 (cursor)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-POINTER-TO-XID:CAPS" title="GDK_POINTER_TO_XID()">GDK_POINTER_TO_XID</a>                  (pointer)
#define             <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-XID-TO-POINTER:CAPS" title="GDK_XID_TO_POINTER()">GDK_XID_TO_POINTER</a>                  (pointer)
<a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> *        <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-lookup-xdisplay" title="gdk_x11_lookup_xdisplay ()">gdk_x11_lookup_xdisplay</a>             (<em class="parameter"><code><span class="type">Display</span> *xdisplay</code></em>);
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-server-time" title="gdk_x11_get_server_time ()">gdk_x11_get_server_time</a>             (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);
<a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-get-user-time" title="gdk_x11_display_get_user_time ()">gdk_x11_display_get_user_time</a>       (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-broadcast-startup-message" title="gdk_x11_display_broadcast_startup_message ()">gdk_x11_display_broadcast_startup_message</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *message_type</code></em>,
                                                         <em class="parameter"><code>...</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-get-startup-notification-id" title="gdk_x11_display_get_startup_notification_id ()">gdk_x11_display_get_startup_notification_id</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-set-startup-notification-id" title="gdk_x11_display_set_startup_notification_id ()">gdk_x11_display_set_startup_notification_id</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);
<span class="returnvalue">Display</span> *           <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-get-xdisplay" title="gdk_x11_display_get_xdisplay ()">gdk_x11_display_get_xdisplay</a>        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-grab" title="gdk_x11_display_grab ()">gdk_x11_display_grab</a>                (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-ungrab" title="gdk_x11_display_ungrab ()">gdk_x11_display_ungrab</a>              (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-error-trap-push" title="gdk_x11_display_error_trap_push ()">gdk_x11_display_error_trap_push</a>     (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-error-trap-pop-ignored" title="gdk_x11_display_error_trap_pop_ignored ()">gdk_x11_display_error_trap_pop_ignored</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-set-cursor-theme" title="gdk_x11_display_set_cursor_theme ()">gdk_x11_display_set_cursor_theme</a>    (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *theme</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-register-standard-event-type" title="gdk_x11_register_standard_event_type ()">gdk_x11_register_standard_event_type</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> event_base</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_events</code></em>);
<span class="returnvalue">int</span>                 <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-get-screen-number" title="gdk_x11_screen_get_screen_number ()">gdk_x11_screen_get_screen_number</a>    (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
<span class="returnvalue">Screen</span> *            <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-get-xscreen" title="gdk_x11_screen_get_xscreen ()">gdk_x11_screen_get_xscreen</a>          (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
const <span class="returnvalue">char</span> *        <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-get-window-manager-name" title="gdk_x11_screen_get_window_manager_name ()">gdk_x11_screen_get_window_manager_name</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);
<span class="returnvalue">XID</span>                 <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-get-monitor-output" title="gdk_x11_screen_get_monitor_output ()">gdk_x11_screen_get_monitor_output</a>   (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);
<a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-lookup-visual" title="gdk_x11_screen_lookup_visual ()">gdk_x11_screen_lookup_visual</a>        (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><span class="type">VisualID</span> xvisualid</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-supports-net-wm-hint" title="gdk_x11_screen_supports_net_wm_hint ()">gdk_x11_screen_supports_net_wm_hint</a> (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>);
<a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-foreign-new-for-display" title="gdk_x11_window_foreign_new_for_display ()">gdk_x11_window_foreign_new_for_display</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);
<a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-lookup-for-display" title="gdk_x11_window_lookup_for_display ()">gdk_x11_window_lookup_for_display</a>   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);
<span class="returnvalue">Window</span>              <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-get-xid" title="gdk_x11_window_get_xid ()">gdk_x11_window_get_xid</a>              (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-set-theme-variant-gtk-only" title="gdk_x11_window_set_theme_variant_gtk_only ()">gdk_x11_window_set_theme_variant_gtk_only</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *variant</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-set-user-time" title="gdk_x11_window_set_user_time ()">gdk_x11_window_set_user_time</a>        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-move-to-current-desktop" title="gdk_x11_window_move_to_current_desktop ()">gdk_x11_window_move_to_current_desktop</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);
<span class="returnvalue">Window</span>              <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-default-root-xwindow" title="gdk_x11_get_default_root_xwindow ()">gdk_x11_get_default_root_xwindow</a>    (<em class="parameter"><code><span class="type">void</span></code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-default-screen" title="gdk_x11_get_default_screen ()">gdk_x11_get_default_screen</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">Display</span> *           <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-default-xdisplay" title="gdk_x11_get_default_xdisplay ()">gdk_x11_get_default_xdisplay</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-grab-server" title="gdk_x11_grab_server ()">gdk_x11_grab_server</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-ungrab-server" title="gdk_x11_ungrab_server ()">gdk_x11_ungrab_server</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">Cursor</span>              <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-cursor-get-xcursor" title="gdk_x11_cursor_get_xcursor ()">gdk_x11_cursor_get_xcursor</a>          (<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
<span class="returnvalue">Display</span> *           <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-cursor-get-xdisplay" title="gdk_x11_cursor_get_xdisplay ()">gdk_x11_cursor_get_xdisplay</a>         (<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
<span class="returnvalue">Visual</span> *            <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-visual-get-xvisual" title="gdk_x11_visual_get_xvisual ()">gdk_x11_visual_get_xvisual</a>          (<em class="parameter"><code><a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);
<span class="returnvalue">Atom</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-atom-to-xatom" title="gdk_x11_atom_to_xatom ()">gdk_x11_atom_to_xatom</a>               (<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> atom</code></em>);
<span class="returnvalue">Atom</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-atom-to-xatom-for-display" title="gdk_x11_atom_to_xatom_for_display ()">gdk_x11_atom_to_xatom_for_display</a>   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> atom</code></em>);
<a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-xatom-to-atom" title="gdk_x11_xatom_to_atom ()">gdk_x11_xatom_to_atom</a>               (<em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);
<a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-xatom-to-atom-for-display" title="gdk_x11_xatom_to_atom_for_display ()">gdk_x11_xatom_to_atom_for_display</a>   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);
<span class="returnvalue">Atom</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-xatom-by-name" title="gdk_x11_get_xatom_by_name ()">gdk_x11_get_xatom_by_name</a>           (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *atom_name</code></em>);
<span class="returnvalue">Atom</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-xatom-by-name-for-display" title="gdk_x11_get_xatom_by_name_for_display ()">gdk_x11_get_xatom_by_name_for_display</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *atom_name</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-xatom-name" title="gdk_x11_get_xatom_name ()">gdk_x11_get_xatom_name</a>              (<em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);
const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-xatom-name-for-display" title="gdk_x11_get_xatom_name_for_display ()">gdk_x11_get_xatom_name_for_display</a>  (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-set-sm-client-id" title="gdk_x11_set_sm_client_id ()">gdk_x11_set_sm_client_id</a>            (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-text-property-to-text-list" title="gdk_x11_display_text_property_to_text_list ()">gdk_x11_display_text_property_to_text_list</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> format</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***list</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-free-text-list" title="gdk_x11_free_text_list ()">gdk_x11_free_text_list</a>              (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **list</code></em>);
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-string-to-compound-text" title="gdk_x11_display_string_to_compound_text ()">gdk_x11_display_string_to_compound_text</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *format</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **ctext</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *length</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-utf8-to-compound-text" title="gdk_x11_display_utf8_to_compound_text ()">gdk_x11_display_utf8_to_compound_text</a>
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *format</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **ctext</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *length</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-free-compound-text" title="gdk_x11_free_compound_text ()">gdk_x11_free_compound_text</a>          (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *ctext</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gdk3-X-Window-System-Interaction.description"></a><h2>Description</h2>
<p>
The functions in this section are specific to the GDK X11 backend.
To use them, you need to include the <code class="literal">&lt;gdk/gdkx.h&gt;</code>
header and use the X11-specific pkg-config files to build your
application (either <code class="literal">gdk-x11-3.0</code> or
<code class="literal">gtk+-x11-3.0</code>).
</p>
<p>
To make your code compile with other GDK backends, guard backend-specific
calls by an ifdef as follows. Since GDK may be built with multiple
backends, you should also check for the backend that is in use (e.g. by
using the <code class="function">GDK_IS_X11_DISPLAY()</code> macro).
</p>
<div class="informalexample"><pre class="programlisting">
#ifdef GDK_WINDOWING_X11
  if (GDK_IS_X11_DISPLAY (display))
    {
      /* make X11-specific calls here */
    }
  else
#endif
#ifdef GDK_WINDOWING_QUARTZ
  if (GDK_IS_QUARTZ_DISPLAY (display))
    {
      /* make Quartz-specific calls here &amp;ast/
    }
  else
#endif
  g_error ("Unsupported GDK backend");
</pre></div>
<p>
</p>
</div>
<div class="refsect1">
<a name="gdk3-X-Window-System-Interaction.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GDK-ROOT-WINDOW:CAPS"></a><h3>GDK_ROOT_WINDOW</h3>
<pre class="programlisting">#define GDK_ROOT_WINDOW()             (gdk_x11_get_default_root_xwindow ())
</pre>
<p>
Obtains the Xlib window id of the root window of the current screen.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GDK-WINDOW-XID:CAPS"></a><h3>GDK_WINDOW_XID()</h3>
<pre class="programlisting">#define             GDK_WINDOW_XID(win)</pre>
<p>
Returns the X window belonging to a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>win</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the Xlib <span class="type">Window</span> of <em class="parameter"><code>win</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-DISPLAY-XDISPLAY:CAPS"></a><h3>GDK_DISPLAY_XDISPLAY()</h3>
<pre class="programlisting">#define             GDK_DISPLAY_XDISPLAY(display)</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GDK-SCREEN-XDISPLAY:CAPS"></a><h3>GDK_SCREEN_XDISPLAY()</h3>
<pre class="programlisting">#define             GDK_SCREEN_XDISPLAY(screen)</pre>
<p>
Returns the display of a X11 <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Display*</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-SCREEN-XNUMBER:CAPS"></a><h3>GDK_SCREEN_XNUMBER()</h3>
<pre class="programlisting">#define GDK_SCREEN_XNUMBER(screen) (gdk_x11_screen_get_screen_number (screen))
</pre>
<p>
Returns the index of a X11 <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the position of <em class="parameter"><code>screen</code></em> among the screens of its display</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-SCREEN-XSCREEN:CAPS"></a><h3>GDK_SCREEN_XSCREEN()</h3>
<pre class="programlisting">#define GDK_SCREEN_XSCREEN(screen) (gdk_x11_screen_get_xscreen (screen))
</pre>
<p>
Returns the screen of a X11 <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Screen*</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-CURSOR-XCURSOR:CAPS"></a><h3>GDK_CURSOR_XCURSOR()</h3>
<pre class="programlisting">#define GDK_CURSOR_XCURSOR(cursor)    (gdk_x11_cursor_get_xcursor (cursor))
</pre>
<p>
Returns the X cursor belonging to a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Cursor</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-CURSOR-XDISPLAY:CAPS"></a><h3>GDK_CURSOR_XDISPLAY()</h3>
<pre class="programlisting">#define GDK_CURSOR_XDISPLAY(cursor)   (gdk_x11_cursor_get_xdisplay (cursor))
</pre>
<p>
Returns the display of a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Display*</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="GDK-POINTER-TO-XID:CAPS"></a><h3>GDK_POINTER_TO_XID()</h3>
<pre class="programlisting">#define GDK_POINTER_TO_XID(pointer) GPOINTER_TO_UINT(pointer)
</pre>
<p>
Converts a <em class="parameter"><code>gpointer</code></em> back to an XID that was previously converted
using <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-XID-TO-POINTER:CAPS" title="GDK_XID_TO_POINTER()"><code class="function">GDK_XID_TO_POINTER()</code></a>.
</p>
</div>
<hr>
<div class="refsect2">
<a name="GDK-XID-TO-POINTER:CAPS"></a><h3>GDK_XID_TO_POINTER()</h3>
<pre class="programlisting">#define GDK_XID_TO_POINTER(pointer) GUINT_TO_POINTER(pointer)
</pre>
<p>
Converts an XID into a <em class="parameter"><code>gpointer</code></em>. This is useful with data structures
that use pointer arguments such as <a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>. Use <a class="link" href="gdk3-X-Window-System-Interaction.html#GDK-POINTER-TO-XID:CAPS" title="GDK_POINTER_TO_XID()"><code class="function">GDK_POINTER_TO_XID()</code></a>
to convert the argument back to an XID.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-lookup-xdisplay"></a><h3>gdk_x11_lookup_xdisplay ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a> *        gdk_x11_lookup_xdisplay             (<em class="parameter"><code><span class="type">Display</span> *xdisplay</code></em>);</pre>
<p>
Find the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> corresponding to <em class="parameter"><code>display</code></em>, if any exists.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xdisplay</code></em> :</span></p></td>
<td>a pointer to an X Display</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>, if found, otherwise <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-server-time"></a><h3>gdk_x11_get_server_time ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             gdk_x11_get_server_time             (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>
Routine to get the current X server time stamp.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>, used for communication with the server.
The window must have GDK_PROPERTY_CHANGE_MASK in its
events mask or a hang will result.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the time stamp.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-get-user-time"></a><h3>gdk_x11_display_get_user_time ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             gdk_x11_display_get_user_time       (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Returns the timestamp of the last user interaction on 
<em class="parameter"><code>display</code></em>. The timestamp is taken from events caused
by user interaction such as key presses or pointer 
movements. See <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-set-user-time" title="gdk_x11_window_set_user_time ()"><code class="function">gdk_x11_window_set_user_time()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the timestamp of the last user interaction</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-broadcast-startup-message"></a><h3>gdk_x11_display_broadcast_startup_message ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_broadcast_startup_message
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *message_type</code></em>,
                                                         <em class="parameter"><code>...</code></em>);</pre>
<p>
Sends a startup notification message of type <em class="parameter"><code>message_type</code></em> to
<em class="parameter"><code>display</code></em>. 
</p>
<p>
This is a convenience function for use by code that implements the
freedesktop startup notification specification. Applications should
not normally need to call it directly. See the <a class="ulink" href="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt" target="_top">Startup
Notification Protocol specification</a> for
definitions of the message types and keys that can be used.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_type</code></em> :</span></p></td>
<td>startup notification message type ("new", "change",
or "remove")</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
<td>a list of key/value pairs (as strings), terminated by a
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> key. (A <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value for a key will cause that key to be
skipped in the output.)</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-get-startup-notification-id"></a><h3>gdk_x11_display_get_startup_notification_id ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gdk_x11_display_get_startup_notification_id
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Gets the startup notification ID for a display.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the startup notification ID for <em class="parameter"><code>display</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-set-startup-notification-id"></a><h3>gdk_x11_display_set_startup_notification_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_set_startup_notification_id
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);</pre>
<p>
Sets the startup notification ID for a display.
</p>
<p>
This is usually taken from the value of the DESKTOP_STARTUP_ID
environment variable, but in some cases (such as the application not
being launched using <code class="function">exec()</code>) it can come from other sources.
</p>
<p>
If the ID contains the string "_TIME" then the portion following that
string is taken to be the X11 timestamp of the event that triggered
the application to be launched and the GDK current event time is set
accordingly.
</p>
<p>
The startup ID is also what is used to signal that the startup is
complete (for example, when opening a window or when calling
<a class="link" href="gdk3-General.html#gdk-notify-startup-complete" title="gdk_notify_startup_complete ()"><code class="function">gdk_notify_startup_complete()</code></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>startup_id</code></em> :</span></p></td>
<td>the startup notification ID (must be valid utf8)</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-get-xdisplay"></a><h3>gdk_x11_display_get_xdisplay ()</h3>
<pre class="programlisting"><span class="returnvalue">Display</span> *           gdk_x11_display_get_xdisplay        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Returns the X display of a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an X display.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-grab"></a><h3>gdk_x11_display_grab ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_grab                (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Call <code class="function">XGrabServer()</code> on <em class="parameter"><code>display</code></em>. 
To ungrab the display again, use <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-ungrab" title="gdk_x11_display_ungrab ()"><code class="function">gdk_x11_display_ungrab()</code></a>. 
</p>
<p>
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-grab" title="gdk_x11_display_grab ()"><code class="function">gdk_x11_display_grab()</code></a>/<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-ungrab" title="gdk_x11_display_ungrab ()"><code class="function">gdk_x11_display_ungrab()</code></a> calls can be nested.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-ungrab"></a><h3>gdk_x11_display_ungrab ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_ungrab              (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Ungrab <em class="parameter"><code>display</code></em> after it has been grabbed with 
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-grab" title="gdk_x11_display_grab ()"><code class="function">gdk_x11_display_grab()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-error-trap-push"></a><h3>gdk_x11_display_error_trap_push ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_error_trap_push     (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Begins a range of X requests on <em class="parameter"><code>display</code></em> for which X error events
will be ignored. Unignored errors (when no trap is pushed) will abort
the application. Use <code class="function">gdk_x11_display_error_trap_pop()</code> or
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-error-trap-pop-ignored" title="gdk_x11_display_error_trap_pop_ignored ()"><code class="function">gdk_x11_display_error_trap_pop_ignored()</code></a>to lift a trap pushed
with this function.
</p>
<p>
See also <a class="link" href="gdk3-General.html#gdk-error-trap-push" title="gdk_error_trap_push ()"><code class="function">gdk_error_trap_push()</code></a> to push a trap on all displays.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-error-trap-pop-ignored"></a><h3>gdk_x11_display_error_trap_pop_ignored ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_error_trap_pop_ignored
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
<p>
Pops the error trap pushed by <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-error-trap-push" title="gdk_x11_display_error_trap_push ()"><code class="function">gdk_x11_display_error_trap_push()</code></a>.
Does not block to see if an error occurred; merely records the
range of requests to ignore errors for, and ignores those errors
if they arrive asynchronously.
</p>
<p>
See <a class="link" href="gdk3-General.html#gdk-error-trap-pop-ignored" title="gdk_error_trap_pop_ignored ()"><code class="function">gdk_error_trap_pop_ignored()</code></a> for the all-displays-at-once
equivalent.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>the display</td>
</tr></tbody>
</table></div>
<p class="since">Since 3.0</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-set-cursor-theme"></a><h3>gdk_x11_display_set_cursor_theme ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_display_set_cursor_theme    (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *theme</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>);</pre>
<p>
Sets the cursor theme from which the images for cursor
should be taken.
</p>
<p>
If the windowing system supports it, existing cursors created
with <a class="link" href="gdk3-Cursors.html#gdk-cursor-new" title="gdk_cursor_new ()"><code class="function">gdk_cursor_new()</code></a>, <a class="link" href="gdk3-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()"><code class="function">gdk_cursor_new_for_display()</code></a> and
<code class="function">gdk_cursor_new_for_name()</code> are updated to reflect the theme
change. Custom cursors constructed with
<a class="link" href="gdk3-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()"><code class="function">gdk_cursor_new_from_pixbuf()</code></a> will have to be handled
by the application (GTK+ applications can learn about
cursor theme changes by listening for change notification
for the corresponding <span class="type">GtkSetting</span>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>theme</code></em> :</span></p></td>
<td>the name of the cursor theme to use, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset
a previously set value</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td>the cursor size to use, or 0 to keep the previous size</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-register-standard-event-type"></a><h3>gdk_x11_register_standard_event_type ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_register_standard_event_type
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> event_base</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_events</code></em>);</pre>
<p>
Registers interest in receiving extension events with type codes
between <em class="parameter"><code>event_base</code></em> and <code class="literal">event_base + n_events - 1</code>.
The registered events must have the window field in the same place
as core X events (this is not the case for e.g. XKB extension events).
</p>
<p>
If an event type is registered, events of this type will go through
global and window-specific filters (see <a class="link" href="gdk3-Windows.html#gdk-window-add-filter" title="gdk_window_add_filter ()"><code class="function">gdk_window_add_filter()</code></a>).
Unregistered events will only go through global filters.
GDK may register the events of some X extensions on its own.
</p>
<p>
This function should only be needed in unusual circumstances, e.g.
when filtering XInput extension events on the root window.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event_base</code></em> :</span></p></td>
<td>first event type code to register</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_events</code></em> :</span></p></td>
<td>number of event type codes to register</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-get-screen-number"></a><h3>gdk_x11_screen_get_screen_number ()</h3>
<pre class="programlisting"><span class="returnvalue">int</span>                 gdk_x11_screen_get_screen_number    (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>
Returns the index of a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the position of <em class="parameter"><code>screen</code></em> among the screens of
its display.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-get-xscreen"></a><h3>gdk_x11_screen_get_xscreen ()</h3>
<pre class="programlisting"><span class="returnvalue">Screen</span> *            gdk_x11_screen_get_xscreen          (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>
Returns the screen of a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Screen*</span>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-get-window-manager-name"></a><h3>gdk_x11_screen_get_window_manager_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *        gdk_x11_screen_get_window_manager_name
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>
Returns the name of the window manager for <em class="parameter"><code>screen</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the name of the window manager screen <em class="parameter"><code>screen</code></em>, or
"unknown" if the window manager is unknown. The string is owned by GDK
and should not be freed.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-get-monitor-output"></a><h3>gdk_x11_screen_get_monitor_output ()</h3>
<pre class="programlisting"><span class="returnvalue">XID</span>                 gdk_x11_screen_get_monitor_output   (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
<p>
Gets the XID of the specified output/monitor.
If the X server does not support version 1.2 of the RANDR
extension, 0 is returned.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>monitor_num</code></em> :</span></p></td>
<td>number of the monitor, between 0 and gdk_screen_get_n_monitors (screen)</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the XID of the monitor</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-lookup-visual"></a><h3>gdk_x11_screen_lookup_visual ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="returnvalue">GdkVisual</span></a> *         gdk_x11_screen_lookup_visual        (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><span class="type">VisualID</span> xvisualid</code></em>);</pre>
<p>
Looks up the <a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> for a particular screen and X Visual ID.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xvisualid</code></em> :</span></p></td>
<td>an X Visual ID.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the <a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> (owned by the screen
object), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the visual ID wasn't found. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-screen-supports-net-wm-hint"></a><h3>gdk_x11_screen_supports_net_wm_hint ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_x11_screen_supports_net_wm_hint (<em class="parameter"><code><a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> property</code></em>);</pre>
<p>
This function is specific to the X11 backend of GDK, and indicates
whether the window manager supports a certain hint from the
Extended Window Manager Hints Specification. You can find this
specification on
<a class="ulink" href="http://www.freedesktop.org" target="_top">http://www.freedesktop.org</a>.
</p>
<p>
When using this function, keep in mind that the window manager
can change over time; so you shouldn't use this function in
a way that impacts persistent application state. A common bug
is that your application can start up before the window manager
does when the user logs in, and before the window manager starts
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-screen-supports-net-wm-hint" title="gdk_x11_screen_supports_net_wm_hint ()"><code class="function">gdk_x11_screen_supports_net_wm_hint()</code></a> will return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for every property.
You can monitor the window_manager_changed signal on <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a> to detect
a window manager change.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
<td>the relevant <a class="link" href="gdk3-GdkScreen.html#GdkScreen" title="GdkScreen"><span class="type">GdkScreen</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>property</code></em> :</span></p></td>
<td>a property atom.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the window manager supports <em class="parameter"><code>property</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-foreign-new-for-display"></a><h3>gdk_x11_window_foreign_new_for_display ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_x11_window_foreign_new_for_display
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);</pre>
<p>
Wraps a native window in a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>. The function will try to
look up the window using <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-window-lookup-for-display" title="gdk_x11_window_lookup_for_display ()"><code class="function">gdk_x11_window_lookup_for_display()</code></a> first.
If it does not find it there, it will create a new window.
</p>
<p>
This may fail if the window has been destroyed. If the window
was already known to GDK, a new reference to the existing
<a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> is returned.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where the window handle comes from.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>an XLib <span class="type">Window</span>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> wrapper for the native
window, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the window has been destroyed. The wrapper
will be newly created, if one doesn't exist already. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-lookup-for-display"></a><h3>gdk_x11_window_lookup_for_display ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="returnvalue">GdkWindow</span></a> *         gdk_x11_window_lookup_for_display   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Window</span> window</code></em>);</pre>
<p>
Looks up the <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> that wraps the given native window handle.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> corresponding to the window handle</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>an XLib <span class="type">Window</span>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> wrapper for the native
window, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is none. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-get-xid"></a><h3>gdk_x11_window_get_xid ()</h3>
<pre class="programlisting"><span class="returnvalue">Window</span>              gdk_x11_window_get_xid              (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>
Returns the X resource (window) belonging to a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>a native <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the ID of <em class="parameter"><code>drawable</code></em>'s X resource.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-set-theme-variant-gtk-only"></a><h3>gdk_x11_window_set_theme_variant_gtk_only ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_window_set_theme_variant_gtk_only
                                                        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *variant</code></em>);</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-set-user-time"></a><h3>gdk_x11_window_set_user_time ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_window_set_user_time        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>);</pre>
<p>
The application can use this call to update the _NET_WM_USER_TIME
property on a toplevel window.  This property stores an Xserver
time which represents the time of the last user input event
received for this window.  This property may be used by the window
manager to alter the focus, stacking, and/or placement behavior of
windows when they are mapped depending on whether the new window
was created by a user action or is a "pop-up" window activated by a
timer or some other event.
</p>
<p>
Note that this property is automatically updated by GDK, so this
function should only be used by applications which handle input
events bypassing GDK.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>A toplevel <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>timestamp</code></em> :</span></p></td>
<td>An XServer timestamp to which the property should be set</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-window-move-to-current-desktop"></a><h3>gdk_x11_window_move_to_current_desktop ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_window_move_to_current_desktop
                                                        (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>
Moves the window to the correct workspace when running under a 
window manager that supports multiple workspaces, as described
in the <a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended 
Window Manager Hints</a>.  Will not do anything if the
window is already on all workspaces.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Windows.html#GdkWindow" title="GdkWindow"><span class="type">GdkWindow</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-default-root-xwindow"></a><h3>gdk_x11_get_default_root_xwindow ()</h3>
<pre class="programlisting"><span class="returnvalue">Window</span>              gdk_x11_get_default_root_xwindow    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Gets the root window of the default screen 
(see <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-get-default-screen" title="gdk_x11_get_default_screen ()"><code class="function">gdk_x11_get_default_screen()</code></a>).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Window</span>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-default-screen"></a><h3>gdk_x11_get_default_screen ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_x11_get_default_screen          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Gets the default GTK+ screen number.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>returns the screen number specified by
the --display command line option or the DISPLAY environment
variable when <a class="link" href="gdk3-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a> calls <code class="function">XOpenDisplay()</code>.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-default-xdisplay"></a><h3>gdk_x11_get_default_xdisplay ()</h3>
<pre class="programlisting"><span class="returnvalue">Display</span> *           gdk_x11_get_default_xdisplay        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Gets the default GTK+ display.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the Xlib <span class="type">Display*</span> for the display
specified in the <code class="option">--display</code> command line option
or the <code class="envar">DISPLAY</code> environment variable.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-grab-server"></a><h3>gdk_x11_grab_server ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_grab_server                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Call <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-grab" title="gdk_x11_display_grab ()"><code class="function">gdk_x11_display_grab()</code></a> on the default display. 
To ungrab the server again, use <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-ungrab-server" title="gdk_x11_ungrab_server ()"><code class="function">gdk_x11_ungrab_server()</code></a>. 
</p>
<p>
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-grab-server" title="gdk_x11_grab_server ()"><code class="function">gdk_x11_grab_server()</code></a>/<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-ungrab-server" title="gdk_x11_ungrab_server ()"><code class="function">gdk_x11_ungrab_server()</code></a> calls can be nested.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-ungrab-server"></a><h3>gdk_x11_ungrab_server ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_ungrab_server               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Ungrab the default display after it has been grabbed with 
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-grab-server" title="gdk_x11_grab_server ()"><code class="function">gdk_x11_grab_server()</code></a>.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-cursor-get-xcursor"></a><h3>gdk_x11_cursor_get_xcursor ()</h3>
<pre class="programlisting"><span class="returnvalue">Cursor</span>              gdk_x11_cursor_get_xcursor          (<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
<p>
Returns the X cursor belonging to a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Cursor</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-cursor-get-xdisplay"></a><h3>gdk_x11_cursor_get_xdisplay ()</h3>
<pre class="programlisting"><span class="returnvalue">Display</span> *           gdk_x11_cursor_get_xdisplay         (<em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
<p>
Returns the display of a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Display*</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-visual-get-xvisual"></a><h3>gdk_x11_visual_get_xvisual ()</h3>
<pre class="programlisting"><span class="returnvalue">Visual</span> *            gdk_x11_visual_get_xvisual          (<em class="parameter"><code><a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a> *visual</code></em>);</pre>
<p>
Returns the X visual belonging to a <a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>visual</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-Visuals.html#GdkVisual" title="GdkVisual"><span class="type">GdkVisual</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>an Xlib <span class="type">Visual*</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-atom-to-xatom"></a><h3>gdk_x11_atom_to_xatom ()</h3>
<pre class="programlisting"><span class="returnvalue">Atom</span>                gdk_x11_atom_to_xatom               (<em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> atom</code></em>);</pre>
<p>
Converts from a <a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> to the X atom for the default GDK display
with the same string value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atom</code></em> :</span></p></td>
<td>A <a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the X atom corresponding to <em class="parameter"><code>atom</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-atom-to-xatom-for-display"></a><h3>gdk_x11_atom_to_xatom_for_display ()</h3>
<pre class="programlisting"><span class="returnvalue">Atom</span>                gdk_x11_atom_to_xatom_for_display   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> atom</code></em>);</pre>
<p>
Converts from a <a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> to the X atom for a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
with the same string value. The special value <a class="link" href="gdk3-Properties-and-Atoms.html#GDK-NONE:CAPS" title="GDK_NONE"><code class="literal">GDK_NONE</code></a>
is converted to <code class="literal">None</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>A <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>atom</code></em> :</span></p></td>
<td>A <a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>, or <a class="link" href="gdk3-Properties-and-Atoms.html#GDK-NONE:CAPS" title="GDK_NONE"><code class="literal">GDK_NONE</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the X atom corresponding to <em class="parameter"><code>atom</code></em>, or <code class="literal">None</code>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-xatom-to-atom"></a><h3>gdk_x11_xatom_to_atom ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             gdk_x11_xatom_to_atom               (<em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);</pre>
<p>
Convert from an X atom for the default display to the corresponding
<a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xatom</code></em> :</span></p></td>
<td>an X atom for the default GDK display</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the corresponding G<span class="type">dkAtom</span>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-xatom-to-atom-for-display"></a><h3>gdk_x11_xatom_to_atom_for_display ()</h3>
<pre class="programlisting"><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="returnvalue">GdkAtom</span></a>             gdk_x11_xatom_to_atom_for_display   (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);</pre>
<p>
Convert from an X atom for a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> to the corresponding
<a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>A <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xatom</code></em> :</span></p></td>
<td>an X atom</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the corresponding <a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a>.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-xatom-by-name"></a><h3>gdk_x11_get_xatom_by_name ()</h3>
<pre class="programlisting"><span class="returnvalue">Atom</span>                gdk_x11_get_xatom_by_name           (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *atom_name</code></em>);</pre>
<p>
Returns the X atom for GDK's default display corresponding to <em class="parameter"><code>atom_name</code></em>.
This function caches the result, so if called repeatedly it is much
faster than <code class="function">XInternAtom()</code>, which is a round trip to the server each time.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>atom_name</code></em> :</span></p></td>
<td>a string</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a X atom for GDK's default display.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-xatom-by-name-for-display"></a><h3>gdk_x11_get_xatom_by_name_for_display ()</h3>
<pre class="programlisting"><span class="returnvalue">Atom</span>                gdk_x11_get_xatom_by_name_for_display
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *atom_name</code></em>);</pre>
<p>
Returns the X atom for a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> corresponding to <em class="parameter"><code>atom_name</code></em>.
This function caches the result, so if called repeatedly it is much
faster than <code class="function">XInternAtom()</code>, which is a round trip to the server each time.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>atom_name</code></em> :</span></p></td>
<td>a string</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a X atom for a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-xatom-name"></a><h3>gdk_x11_get_xatom_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gdk_x11_get_xatom_name              (<em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);</pre>
<p>
Returns the name of an X atom for GDK's default display. This
function is meant mainly for debugging, so for convenience, unlike
<code class="function"><code class="function">XAtomName()</code></code> and <a class="link" href="gdk3-Properties-and-Atoms.html#gdk-atom-name" title="gdk_atom_name ()"><code class="function">gdk_atom_name()</code></a>, the result 
doesn't need to be freed. Also, this function will never return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, 
even if <em class="parameter"><code>xatom</code></em> is invalid.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>xatom</code></em> :</span></p></td>
<td>an X atom for GDK's default display</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>name of the X atom; this string is owned by GTK+,
so it shouldn't be modifed or freed.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-get-xatom-name-for-display"></a><h3>gdk_x11_get_xatom_name_for_display ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gdk_x11_get_xatom_name_for_display  (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><span class="type">Atom</span> xatom</code></em>);</pre>
<p>
Returns the name of an X atom for its display. This
function is meant mainly for debugging, so for convenience, unlike
<code class="function">XAtomName()</code> and <a class="link" href="gdk3-Properties-and-Atoms.html#gdk-atom-name" title="gdk_atom_name ()"><code class="function">gdk_atom_name()</code></a>, the result doesn't need to
be freed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where <em class="parameter"><code>xatom</code></em> is defined</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xatom</code></em> :</span></p></td>
<td>an X atom</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>name of the X atom; this string is owned by GDK,
so it shouldn't be modifed or freed.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-set-sm-client-id"></a><h3>gdk_x11_set_sm_client_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_set_sm_client_id            (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);</pre>
<p>
Sets the <code class="literal">SM_CLIENT_ID</code> property on the application's leader window so that
the window manager can save the application's state using the X11R6 ICCCM
session management protocol.
</p>
<p>
See the X Session Management Library documentation for more information on
session management and the Inter-Client Communication Conventions Manual
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>sm_client_id</code></em> :</span></p></td>
<td>the client id assigned by the session manager when the
connection was opened, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove the property.</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-text-property-to-text-list"></a><h3>gdk_x11_display_text_property_to_text_list ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_x11_display_text_property_to_text_list
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> format</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *text</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> length</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***list</code></em>);</pre>
<p>
Convert a text string from the encoding as it is stored
in a property into an array of strings in the encoding of
the current locale. (The elements of the array represent the
nul-separated elements of the original text string.)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>The <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where the encoding is defined</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>encoding</code></em> :</span></p></td>
<td>an atom representing the encoding. The most
common values for this are STRING, or COMPOUND_TEXT.
This is value used as the type for the property</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
<td>the format of the property</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
<td>The text data</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>The number of items to transform</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>location to store an  array of strings in
the encoding of the current locale. This array should be
freed using <code class="function">gdk_free_text_list()</code>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the number of strings stored in list, or 0,
if the conversion failed</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-free-text-list"></a><h3>gdk_x11_free_text_list ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_free_text_list              (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **list</code></em>);</pre>
<p>
Frees the array of strings created by
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-text-property-to-text-list" title="gdk_x11_display_text_property_to_text_list ()"><code class="function">gdk_x11_display_text_property_to_text_list()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the value stored in the <em class="parameter"><code>list</code></em> parameter by
a call to <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-text-property-to-text-list" title="gdk_x11_display_text_property_to_text_list ()"><code class="function">gdk_x11_display_text_property_to_text_list()</code></a>.</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-string-to-compound-text"></a><h3>gdk_x11_display_string_to_compound_text ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_x11_display_string_to_compound_text
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *format</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **ctext</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *length</code></em>);</pre>
<p>
Convert a string from the encoding of the current
locale into a form suitable for storing in a window property.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>the <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> where the encoding is defined</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
<td>a nul-terminated string</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>encoding</code></em> :</span></p></td>
<td>location to store the encoding atom
(to be used as the type for the property). <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
<td>location to store the format of the property. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ctext</code></em> :</span></p></td>
<td>location to store newly
allocated data for the property. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>the length of <em class="parameter"><code>ctext</code></em>, in bytes</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>0 upon success, non-zero upon failure</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-display-utf8-to-compound-text"></a><h3>gdk_x11_display_utf8_to_compound_text ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_x11_display_utf8_to_compound_text
                                                        (<em class="parameter"><code><a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gdk3-Properties-and-Atoms.html#GdkAtom" title="GdkAtom"><span class="type">GdkAtom</span></a> *encoding</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *format</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> **ctext</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *length</code></em>);</pre>
<p>
Converts from UTF-8 to compound text.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td>a <a class="link" href="gdk3-GdkDisplay.html#GdkDisplay" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
<td>a UTF-8 string</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>encoding</code></em> :</span></p></td>
<td>location to store resulting encoding. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
<td>location to store format of the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ctext</code></em> :</span></p></td>
<td>location to store the data of the result. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td>location to store the length of the data
stored in <em class="parameter"><code>ctext</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the conversion succeeded,
otherwise <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-x11-free-compound-text"></a><h3>gdk_x11_free_compound_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_x11_free_compound_text          (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *ctext</code></em>);</pre>
<p>
Frees the data returned from <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-string-to-compound-text" title="gdk_x11_display_string_to_compound_text ()"><code class="function">gdk_x11_display_string_to_compound_text()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>ctext</code></em> :</span></p></td>
<td>The pointer stored in <em class="parameter"><code>ctext</code></em> from a call to
<a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-string-to-compound-text" title="gdk_x11_display_string_to_compound_text ()"><code class="function">gdk_x11_display_string_to_compound_text()</code></a>.</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.24</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.17</div>
</body>
</html>